Programming With QuickTime VR 2.1

Previous | Overview | Contents | Next

Control Settings

The controlSettings field of the object sample atom (Object Sample Atom Structure) is a long integer that specifies a set of control settings for an object node. Control settings specify whether the object can wrap during panning and tilting, as well as other features of the node. The control settings are specified using these bit flags:

enum QTVRControlSettings {
    kQTVRObjectWrapPanOn                        = (1 << 0),
    kQTVRObjectWrapTiltOn                       = (1 << 1),
    kQTVRObjectCanZoomOn                        = (1 << 2),
    kQTVRObjectReverseHControlOn                = (1 << 3),
    kQTVRObjectReverseVControlOn                = (1 << 4),
    kQTVRObjectSwapHVControlOn                  = (1 << 5),
    kQTVRObjectTranslationOn                    = (1 << 6)
};

See the section "Control Settings," , for a more complete description of these control settings.

Constant descriptions

kQTVRObjectWrapPanOn
If this bit is set, enable wrapping during panning. When this control setting is enabled, the user can wrap around from the current pan constraint maximum value to the pan constraint minimum value (or vice versa) using the mouse or arrow keys.
kQTVRObjectWrapTiltOn
If this bit is set, enable wrapping during tilting. When this control setting is enabled, the user can wrap around from the current tilt constraint maximum value to the tilt constraint minimum value (or vice versa) using the mouse or arrow keys.
kQTVRObjectCanZoomOn
If this bit is set, enable zooming. When this control setting is enabled, the user can change the current field of view using the zoom-in and zoom-out keys on the keyboard (or using the VR controller buttons).
kQTVRObjectReverseHControlOn
If this bit is set, reverse the direction of the horizontal control.
kQTVRObjectReverseVControlOn
If this bit is set, reverse the direction of the vertical control.
kQTVRObjectSwapHVControlOn
If this bit is set, exchange the horizontal and vertical controls.
kQTVRObjectTranslationOn
If this bit is set, enable translation. When this setting is enabled, the user can translate using the mouse when either the translate key is held down or the controller translation mode button is toggled on.
© 1997 Apple Computer, Inc.

Previous | Overview | Contents | Next